Skip to main content

Creating an API Client in Akamai

Creating the API Client​

You can add your Akamai CDN account to IO River and use it with your services. To add Akamai as one of your CDN providers, you need to create an API client in your Akamai account.

  1. Sign in to your Akamai account.
  2. Navigate to the left sidebar and choose Identity & access.
  3. Under the Users and API Clients tab, click the Create API Client button.
  4. Click the Advanced button.
  5. Fill out the new API client form:
    1. Name - Type a name for the client.
    2. Description - Type a description for the client.
    3. APIs - Check the Select APIs option. When the list of permissions appears, click the Clear API selection, and pick the following permissions:
      • Property Manager (PAPI) - READ-WRITE
      • CPS - READ-WRITE
      • Domain Ownership Manager - READ-WRITE
      • Manage Edge Hostnames API - READ-WRITE
      • Datastream Config - READ-WRITE
      • CCU APIs - READ-WRITE
      • Enhanced Content Control Utility (ECCU) - READ-WRITE
      • Reporting API - READ-WRITE
      • EdgeWorkers - READ-WRITE
      • DataStream EdgeWorkers Config - READ-WRITE
      • CPcode and Reporting group - READ-ONLY
      • Contracts-API_Contracts - READ-ONLY
    4. Click Submit.
    5. Click Create API client.
  6. Review the created API client and copy its credentials:
    • client_secret
    • host (base URL)
    • access_token
    • client_token

Example​

client_secret = i3YpvJFBiScVG6J6JJPzI9aJk32XmMOYTRDQCNgCFXY=
host = akab-grfave5t2bgnf7gp-thnbutolqvre5evi.luna.akamaiapis.net
access_token = akab-tznh3naf2xyrtepu-6pwdbmjsqy7la4vs
client_token = akab-gbq3efk7iuw3nk6e-2al2mw7xdwlunph

Save the created credentials, and paste it when you add your Akamai CDN here.

Using Geo Headers in Behaviors​

Note: If you intend to create behaviors that rely on Geo headers, add EdgeScape to your Akamai account.

Creating a Akamai Functions Token​

In Akamai, the IO River WAF runs as an Akamai Function, which has a separate authorization framework. Learn more about Akamai Functions.

If you are using IO River WAF, you will need to create an Akamai Function Token, a dedicated token that IO River can use to deploy the WAF engine in Akamai Functions. The token is created using the Akamai Functions CLI, called spin.

  1. Install spin.
  2. Install the Akamai spin plugin.
  3. Login to Akamai Functions.
  4. Create an Akamai Functions token using the following command
spin aka auth token create --name ioriver -e 90
  1. Review the command output
INT ✘  compute-apps  
A personal access token has been created! The token will expire 90 days from now.
Please store this token in a safe place, as it will not be shown again.
Here is your access token: pat_M6FXXXXXXXXXXXXXXXXXXXV4XP

Copy the token pat_M6FXXXXXXXXXXXXXXXXXXXV4XP from the command output, and paste it when you add your Akamai CDN here.